Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Functions / Creating and Manipulating Format Objects

GXForEachJobFormatDo

You can use the GXForEachJobFormatDo function to manipulate each format object in a particular job object.

void GXForEachJobFormatDo (gxJob aJob, gxFormatProc aFormatProc,
                           void *refCon);

aJob

A reference to the job object associated with a particular format object.

aFormatProc

A pointer to the function to call for each format object in a job object.

refCon

The reference constant passed to the function.

DESCRIPTION

The GXForEachJobFormatDo function calls the application-defined function specified in the aFormatProc parameter for each format object associated with the job object specified in the aJob parameter. The GXForEachJobFormatDo function terminates when the application-defined function returns gxStopLooping or all format objects associated with the job object have been processed. The first format object to be processed is the default format.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 3-17 on page 3-60 shows how to use the GXForEachJobFormatDo function to access a format object function for each format object in a particular job object.

For information about setting up the function that is called each time through the loop, see "Looping Through Format Objects" on page 3-126.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help